home *** CD-ROM | disk | FTP | other *** search
/ Aminet 44 / Aminet 44 (2001)(GTI - Schatztruhe)[!][Aug 2001].iso / Aminet / dev / mui / MCC_NListtree.readme < prev    next >
Text File  |  2001-07-04  |  14KB  |  317 lines
  1. Short:    MUI list tree class for NList
  2. Author:   cs@aphaso.de (Carsten Scholling)
  3. Uploader: cs@aphaso.de (Carsten Scholling)
  4. Version:  18.8
  5. Type:     dev/mui
  6. Requires: OS2.x, MUI3.8, NList19.98
  7. Replaces: MCC_NListtree.lha
  8.  
  9.  
  10. Description:
  11. ¯¯¯¯¯¯¯¯¯¯¯
  12.   This  MUI  custom  class provides you with an easy way of displaying list
  13. entries  in  a  sorted  form, a so called tree-structure.  A Tree-structure
  14. will be selected, when data should be optical seperated from each other.
  15.  
  16.   NListtree is intresting for programmers and the end-user also and easy to
  17. use.   So  far  as  implemented  by  the  programmer  and  needfull  in the
  18. application environment, this class allows the fully free recreation of the
  19. list using drag&drop (short d&d) with support of multiselection.
  20.  
  21.   First  time  in  a  list  tree  class  it  is  possible  to move complete
  22. structures.  That means, that the complete tree of the moved entry, back to
  23. the  root-list,  is  recreated  at the destination if the programmer allows
  24. this.  The same for copying entries, which is also implemented.
  25.  
  26.  
  27.  
  28. Requirements:
  29. ¯¯¯¯¯¯¯¯¯¯¯¯
  30.  - OS2.x
  31.  - MUI3.8
  32.  - MCC_NList 0.90 (NList.mcc 19.98)
  33.  
  34.  
  35. Installation:
  36. ¯¯¯¯¯¯¯¯¯¯¯¯
  37.  - Simply use the supplied installer script.
  38.  
  39.  
  40.  
  41. History:
  42. ¯¯¯¯¯¯¯
  43.  
  44.   V18.8 - Public release
  45.  
  46.      FIXED: Drag 'n Drop function drop type  rework for errors  which  occured
  47.             when overloading the drop type method.
  48.      ADDED: MUIM_NListtree_DropType, MUIM_NListtree_DropDraw.
  49.      FIXED: Sometimes drag 'n drop didn't work (no drop operation possible).
  50.      FIXED: Version string.
  51.  
  52.  
  53.   V18.7 - Public release
  54.  
  55.      ADDED: Now, ...Select_Active with ...Select_Ask returns the  active entry
  56.             instead of 0.
  57.      FIXED: A selected entry  in a list node does not  memory its state over 2
  58.             or more close/open on this list node (Thx to Andrija Antonijevic)
  59.      FIXED: ...Select_Active ...Select_Toggle  caused an alert  without active
  60.             entry (Thx to Andrija Antonijevic)
  61.      FIXED: After a  MUIA_NListtree_Quiet,  sometimes the  tree was  refreshed
  62.             twice.  This is a very old bug i've forgotten for some weeks. (Thx
  63.             to Sebastian Bauer for reporting it again)
  64.      ADDED: MUIM_NListtree_Clear
  65.      ADDED: Check for outdated NList.mcc.  If version is lower than 19.97, NLt
  66.             aborts.
  67.      REWR:  Rewritten  selection code for  new NList feature.  Attention! With
  68.             a lower  NList version than 19.98,  NListtree disables  his multi-
  69.             selection feature now!
  70.  
  71.  
  72.   V18.6 - Public Beta release 5
  73.  
  74.      FIXED: Fixed bug introduced  with multiselection that  allows dragging of
  75.             entries to  their children  what ends up in a  crash  (reported by
  76.             Sebastian Bauer, thx)
  77.      FIXED: Rewritten entry position calculation code. Never  more  accidently
  78.             deleted entries!
  79.      FIXED: Drop type "Sorted" never occured. Fixed!
  80.      FIXED: Renaming the user field was not possible. Fixed.
  81.      ADDED: Added MUIV_NListtree_Insert_ListNode_ActiveFallback  (see autodocs
  82.             for more details) (suggested by Sebastian Bauer)
  83.      ADDED: Added a  second  find method and  the corresponding hook  for user
  84.             data. This is meant as a backup if  searching for different fields
  85.             and/or values (MUIA_NListtree_FindUserDataHook,
  86.             MUIM_NListtree_FindUserData).
  87.      ADDED: Added  MUIA_NListtree_ShowTree for  enabling/disabling  the  tree.
  88.             This is usefull for lists which can be sorted in different cols.
  89.      ADDED: Added spanish catalog (Thx to Javier de las Rivas).
  90.      ADDED: Added trigger attribute MUIA_NListtree_SelectChange.
  91.      FIXED: Inserting open  nodes into a closed node  caused NListtree to mis-
  92.             calculate the positions (reported by Luca 'Hexaae' Longone, thx).
  93.  
  94.  
  95.   V18.6 - Beta release 4
  96.  
  97.      On the fly-release for some persons.
  98.  
  99.  
  100.   V18.6 - Beta release 3
  101.  
  102.      - Added   MUIA_NListtree_DropType,   MUIA_NListtree_DropTarget   and
  103.        MUIA_NListtree_DropTargetPos.
  104.      - Now, MinLineHeight will only be set when image is heigher than the
  105.        current minimum.
  106.      - When using Next/PrevSelected method and deleting selected entries,
  107.        machine crashes. Fixed.
  108.      - Added   MUIV_NListtree_FindName_Flag_Reverse  (suggested by Thomas
  109.        Igracki)
  110.      - Added MUIV_NListtree_FindName_Flag_StartNode  (suggested by Thomas
  111.        Igracki)
  112.      - Added italian catalog.  Thanks to Andrea Zanellato  for the trans-
  113.        lation.
  114.      - Added NULL pointer check to internal construct/destruct hooks.
  115.      - Added MUIV_NListtree_Remove_TreeNode_Selected.
  116.  
  117.  
  118.   V18.6 - Beta release 2
  119.  
  120.      - Changed look and feel of the mcp.
  121.      - mcc was not closed in mcp. Fixed!
  122.      - Source cleanup.
  123.      - Modifications to the tree drawing functions.  Should look a little
  124.        bit nicer now.
  125.      - Added MUIA_NListtree_CopyToClipHook and MUIM_NListtree_CopyToClip.
  126.        Suggested by Harald Frank.
  127.      - Added an own context menu for copying  strings to clipboard units.
  128.      - Added a  translation  package  for easy  translation of  NListtree
  129.        catalogs.
  130.  
  131.  
  132.   V18.6 - Beta release 1
  133.  
  134.      - MUIV_NListtree_MultiSelect_Shifted now works as expected
  135.      - Crashs/hits on exit (dispose) finally removed!
  136.      - Sorting a closed  node forced entries to  show up. Fixed!  (Thx to
  137.        Thomas Igracki)
  138.      - Reimplemented (oups!)  MUIV_NListtree_GetEntry_Flag_SameLevel  and
  139.        MUIV_NListtree_GetEntry_Flag_Visible (Thx to Thomas Igracki)
  140.      - DoubleClick again: Removed  silly bug  that causes  double notify-
  141.        cation on double click. Hey Matthias: Remove workaround ;-)
  142.      - Added some ball images from Henning Thielmann, thx a lot.
  143.      - Fixed  DropType bug  which caused an eight bit  left shift  of the
  144.        original values.
  145.      - Special image in .mcp was not  ghosted when starting MUI without a
  146.        saved configuration. Fixed. Bumped to V18.6.
  147.      - Without  configuration,  no or a  wrong image  was shown  in tree.
  148.        Fixed! Reported by Harald Frank, thx.
  149.  
  150.  
  151.   V18.5 - Public release
  152.  
  153.      - Added  preparse  string  pointer to  MUIP_NListtree_DisplayMessage
  154.        (suggested by Andrija Antonijevic)
  155.      - Made   drop  types  public  (same  values  as  NList  drop  types)
  156.        (suggested by Sebastian Bauer)
  157.      - MUIA_NListtree_Doubleclick  is now  triggered  if  return  key  is
  158.        pressed (reported by Sebastian Bauer)
  159.      - NULL pointer  will  be  replaced  with "*** NULL POINTER ***" text
  160.        now.
  161.      - Multi test  hook will  now be  launched in  all cases  when  multi
  162.        selecting (reported by Thomas Igracki)
  163.      - Removed bug  in NextSelected  function which  caused returning  of
  164.        trash (reported by Thomas Igracki, thx).
  165.      - Added MUIM_NListtree_PrevSelected (suggested by Thomas Igracki)
  166.      - Added MUIV_NListtree_FindName_Flag_Selected to  only find selected
  167.        entries in MUIM_NListtree_FindName (suggested by Thomas Igracki)
  168.      - Fixed bug in DoubleClick: Setting  DoubleClick to  any other  than
  169.        All has no effect (reported by Mark Harman, thx)
  170.      - Added new DoubleClick value: MUIV_NListtree_DoubleClick_NoTrigger.
  171.        This means, that double clicking  an entry  is disabled  including
  172.        disabled trigger (attribute and method).
  173.  
  174.  
  175.   V18.4 - Broken public release, sorry :((
  176.  
  177.      - Added MUIM_NListtree_InsertStruct
  178.      - Added some new internal attributes and methods ;-)
  179.      - Fixed autodocs a litte bit (reported by Allan Odgaard)
  180.      - Added nesting count to MUIA_NListtree_Quiet (suggested by Allan
  181.        Odgaard)
  182.      - Fixed Enforcer hit when deleting the last list entry in root node
  183.        (reported by Matthias Böcker)
  184.      - Fixed Enforcer  hits when listview  is the active object, no entry
  185.        is active and using cursor left/right
  186.      - Added MUIM_NListtree_Active and MUIM_NListtree_DoubleClick methods
  187.      - Removed PoolWatch-hits (reported by Andrija Antonijevic. Thx!) and
  188.        written the book "Do Not Assume That Making Only Two Small Changes
  189.        In A Function Does Not Affect The Functionality"
  190.      - Removed (hopefully) crash on exit (dispose)
  191.  
  192.  
  193.   V18.3 - Public release
  194.  
  195.      - MUA_NListtree_Quiet  does not work as  expected  (reported by Thomas
  196.        Igracki, Thx!)
  197.      - User defined compare- and findname-hooks crash! Fixed!  (reported by
  198.        Thomas Igracki, Thx!)
  199.      - Now, NListtree is really quiet if MUIA_NListtree_Quiet is set!
  200.      - Reactivation of copied, moved and exchanged entries works better now.
  201.      - OpenAutoScroll now  works as expected,  added  new config  item Open
  202.        scroll (Thx to Matthias Bethke).
  203.  
  204.  
  205.   V18.2 - Public release
  206.  
  207.      - Added multiselection feature
  208.      - Fixed some small cosmetical problems
  209.      - Implemented arrows as MUI images
  210.      - Implemented Copy method
  211.      - Implemented KeepStructure flag for recreation of the complete
  212.        structure in Move and Copy
  213.  
  214.  
  215.   V18.1 - Internal release
  216.  
  217.      - Completely rewritten graphics stuff. Now in all cases predefined and
  218.        precreated images  where used.  This fixes many graphic bugs occured
  219.        in the old 18.0.
  220.      - After deleting an entry,  the old entry  remains internally  active.
  221.        Using this entry crashed the machine. Fixed!
  222.      - Moving   marker   with    the   cursor   keys   did    not   trigger
  223.        MUIA_NListtree_Active. Fixed!
  224.      - When deleting entries, MUIA_NListtree_Active was triggered two times.
  225.        Fixed
  226.      - Deleting  an  entry without  entries  in  the list  caused recursive
  227.        function calling and stack overflow ;-) Fixed!
  228.      - Insertion  had some bugs which  caused the machine to hang or crash.
  229.        Fixed!
  230.  
  231.  
  232.   V18.0 - Initial public beta release
  233.  
  234.  
  235. ============================= Archive contents =============================
  236.  
  237. Original  Packed Ratio    Date     Time    Name
  238. -------- ------- ----- --------- --------  -------------
  239.    18736    9103 51.4% 02-Mar-01 17:40:08 +NListtree-Demo
  240.     2889    1802 37.6% 23-Jul-00 01:11:22 +NListtree-Demo.info
  241.     2032    1772 12.7% 22-Jul-00 01:55:14 +Developer.info
  242.     2032    1772 12.7% 06-Feb-00 17:41:08 +AutoDocs.info
  243.    71174   14750 79.2% 10-Jun-01 20:52:40 +MCC_NListtree.doc
  244.     2570    1455 43.3% 06-Feb-00 17:41:10 +MCC_NListtree.doc.info
  245.    99060   17268 82.5% 10-Jun-01 20:52:46 +MCC_NListtree.guide
  246.     2933    2307 21.3% 06-Feb-00 17:43:06 +MCC_NListtree.guide.info
  247.    46452    6200 86.6% 10-Jun-01 20:52:42 +NListtree_mcc.h
  248.     2314     615 73.4% 04-Feb-00 20:21:52 +compiler.h
  249.    21742    3305 84.7% 05-Feb-01 23:10:16 +NListtree_mcc.h
  250.    35734    6879 80.7% 02-Mar-01 17:39:56 +NListtree-Demo.c
  251.    22454    3408 84.8% 10-Jun-01 20:52:38 +NListtree_mcc.h
  252.     2032    1774 12.6% 22-Jul-00 01:55:14 +Docs.info
  253.     2032    1771 12.8% 06-Feb-00 16:14:06 +English.info
  254.    23076    9156 60.3% 10-Jun-01 18:43:10 +NListtree.mcc.guide
  255.     2933    2308 21.3% 06-Feb-00 17:42:58 +NListtree.mcc.guide.info
  256.     2032    1774 12.6% 22-Jul-00 01:56:16 +HTML.info
  257.     2032    1773 12.7% 22-Jul-00 01:59:26 +english.info
  258.      900     328 63.5% 10-Jun-01 20:52:36 +bugs.html
  259.     1088     422 61.2% 10-Jun-01 20:52:36 +credits.html
  260.     2041     917 55.0% 10-Jun-01 20:52:36 +disclaimer.html
  261.     9357    3590 61.6% 10-Jun-01 20:52:38 +history.html
  262.      224     224  0.0% 22-Jul-00 01:13:30 +home.gif
  263.     1061     407 61.6% 10-Jun-01 20:52:36 +installation.html
  264.     2594    1187 54.2% 10-Jun-01 20:52:36 +intro.html
  265.     1671     724 56.6% 10-Jun-01 20:52:36 +licence.html
  266.     2099     798 61.9% 10-Jun-01 20:52:36 +main.html
  267.     1487     681 54.2% 10-Jun-01 20:52:38 +mcc-install.html
  268.     1848     756 59.0% 10-Jun-01 20:52:38 +mui.html
  269.      206     206  0.0% 22-Jul-00 01:13:30 +next.gif
  270.     3631    1526 57.9% 10-Jun-01 20:52:38 +nlist.html
  271.      206     206  0.0% 22-Jul-00 01:13:30 +prev.gif
  272.     1025     394 61.5% 10-Jun-01 20:52:36 +requirements.html
  273.     1463     601 58.9% 10-Jun-01 20:52:38 +thanks.html
  274.      205     205  0.0% 22-Jul-00 01:13:30 +toc.gif
  275.     1158     468 59.5% 10-Jun-01 20:52:38 +todo.html
  276.      956     346 63.8% 10-Jun-01 20:52:38 +updates.html
  277.     3338    1426 57.2% 10-Jun-01 20:52:36 +usage.html
  278.     2032    1772 12.7% 22-Jul-00 01:56:34 +Images.info
  279.     2032    1773 12.7% 22-Jul-00 01:59:56 +aphaso.info
  280.      252     190 24.6% 26-Dec-99 14:43:22 +ClosedDrawerWin98.ilbm
  281.     1772    1142 35.5% 02-Mar-01 17:33:24 +ClosedNode.image
  282.     1608    1049 34.7% 02-Mar-01 17:33:28 +ClosedNodeWin98.image
  283.     1240     469 62.1% 05-Aug-00 16:42:30 +GlowDrawerClosed.ilbm
  284.     1730     828 52.1% 05-Aug-00 16:41:30 +GlowDrawerOpen.ilbm
  285.      252     206 18.2% 28-Oct-80 20:46:04 +ClosedBall.mbr
  286.      248     194 21.7% 28-Oct-80 20:42:12 +OpenBall.mbr
  287.      276     222 19.5% 28-Oct-80 20:52:46 +ClosedBall.mbr
  288.      272     201 26.1% 28-Oct-80 20:53:04 +OpenBall.mbr
  289.      250     212 15.2% 26-Dec-99 14:44:02 +OpenDrawerWin98.ilbm
  290.     1772    1147 35.2% 02-Mar-01 17:33:30 +OpenNode.image
  291.     1556    1017 34.6% 02-Mar-01 17:33:34 +OpenNodeWin98.image
  292.    41636   20046 51.8% 10-Jun-01 20:52:18 +NListtree.mcc
  293.    17900    7784 56.5% 10-Jun-01 20:52:30 +NListtree.mcp
  294.    41596   19998 51.9% 10-Jun-01 20:51:40 +NListtree020.mcc
  295.    41632   20004 51.9% 10-Jun-01 20:51:02 +NListtree040.mcc
  296.    41624   20023 51.8% 10-Jun-01 20:50:24 +NListtree060.mcc
  297.     1628     837 48.5% 22-Feb-01 19:50:14 +NListtree.mcp.catalog
  298.     4526    1544 65.8% 22-Feb-01 19:50:12 +NListtree.mcp.ct
  299.     1680     830 50.5% 28-Nov-00 12:47:26 +NListtree.mcp.catalog
  300.     3470    1389 59.9% 28-Nov-00 12:47:38 +NListtree.mcp.ct
  301.     2040    1038 49.1% 25-Feb-01 17:20:28 +NListtree.mcp.catalog
  302.     1632     845 48.2% 21-Nov-00 21:35:00 +NListtree.mcp.catalog
  303.     4419    1511 65.8% 21-Nov-00 21:34:58 +NListtree.mcp.ct
  304.     1754     901 48.6% 15-Nov-00 22:09:06 +NListtree.mcp.catalog
  305.     4479    1508 66.3% 19-Nov-00 20:01:20 +NListtree.mcp.ct
  306.     1774     952 46.3% 27-Feb-01 11:00:24 +NListtree.mcp.catalog
  307.     2551     981 61.5% 23-Feb-01 20:48:38 +NListtree.mcp.cd
  308.     1782     906 49.1% 14-Jan-01 11:48:34 +NListtree.mcp.catalog
  309.     3457    1481 57.1% 14-Jan-01 12:46:48 +NListtree.mcp.ct
  310.   192533   39111 79.6% 01-Mar-01 18:30:40 +MCC-Install
  311.     2758    1904 30.9% 22-Jul-00 01:55:14 +MCC-Install.info
  312.     9735    3726 61.7% 10-Jun-01 18:43:18 +MCC_NListtree.readme
  313.     2570    1454 43.4% 22-Jul-00 01:55:14 +MCC_NListtree.readme.info
  314.     2032    1774 12.6% 22-Jul-00 02:22:48  MCC_NListtree.info
  315. -------- ------- ----- --------- --------
  316.   845317  265573 68.5% 12-Jun-101 03:47:14   76 files
  317.